home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Aminet 45
/
Aminet 45 (2001)(GTI - Schatztruhe)[!][Oct 2001].iso
/
Aminet
/
dev
/
c
/
vbcc.lha
/
vbcc
/
doc
/
wosdb.doc
< prev
Wrap
Text File
|
2001-06-25
|
3KB
|
85 lines
wosdb V0.4 VBCC ANSI C Compiler Reference Manual wosdb V0.4
NAME
wosdb - a simple WarpOS debugger
SYNOPSIS
wosdb [file name] [arguments...]
DESCRIPTION
wosdb is a low-level debugger, which supports basic debugger
functionalities like single-step trace mode, breakpoints, disas-
sembler, memory dump, etc.. It also takes advantage from symbol
hunks (HUNK_SYMBOL) in WarpOS programs.
The debugger is not very useful, when the executable doesn't
provide any symbols, so you should make sure that your compiler
generates them.
vbcc:
vlink must not strip any symbols from the final executable.
This can be achieved by omitting the options -s and -x. You
can make a new config file, e.g. "warpos_debug" for this
purpose.
StormC:
Set the toggle for "Write Debugsymbols" in
Settings -> C/C++ Compiler -> Options.
Note: egcs-WOS is not supported, because the generated code
doesn't conform to the PowerOpen-ABI, used under WarpOS.
When arguments are specified behind the file name, they will
be passed via RunCommand() to the 68k launch code of the WarpOS
program.
COMMANDS
+ Skip to next instruction
- Skip to previous instruction
? Show help
? <exp> Evaluate expression
@r<n> = <exp> Set GP register
@f<n> = <flt exp> Set FPU register
L "name" [args...] Load WOS program for debugging
U Unload current program
S Show all symbols
b Show all breakpoints
b <exp> Set normal breakpoint (trap instruction)
bc <exp> Clear breakpoint
bt <exp> Set temporary breakpoint
d [<exp>] Disassemble
fpr Show FPU registers
g Run program
g <exp> Run program until specified address reached
gpr Show GP registers
m [<exp>] Memory dump
n Break at next instruction (trace over calls)
r Show all CPU registers and current instruction
s Single step instruction
tb Show stack frame trace-back
x Exit debugger and unload debug task
EXPRESSIONS
Expressions may consist of decimal, hexadecimal (0x...) or
octal (0...) constants, symbols (read from HUNK_SYMBOL) and
registers. The operations +, -, *, / and terms are allowed.
Registers can be referenced by using the '@' prefix, e.g. @r1
for contents of stack frame. Supported registers in expressions
are: @r<n>, @lr, @ctr, @pc
LEGAL
wosdb is freeware.
BUGS
I can't believe it... None? :)
Frank Wille 05-Mar-2000 frank@phoenix.owl.de